home *** CD-ROM | disk | FTP | other *** search
/ The Original Shareware 1.1 / The Original Shareware (WeMake CDs)(Volume 1.1)(CDs, Inc)(1993).iso / 30 / autosn31.zip / AUTOSCAN.DOC < prev    next >
Text File  |  1991-05-07  |  14KB  |  328 lines
  1.  
  2.                ╓──╖
  3.                ║  ║
  4.                ║  ║  ╥   ╥ ╓─╥─╖ ╓───╖ ╓───  ╓───╖  ╓──╖  ╥┐   ╥
  5.               ╓╨──╨╖ ║   ║   ║   ║   ║ ║     ║      ║  ║  ║└┐  ║
  6.               ║    ║ ║   ║   ║   ║   ║ ╙───╖ ║     ╓╨──╨╖ ║ └┐ ║
  7.               ║    ║ ║   ║   ║   ║   ║     ║ ║     ║    ║ ║  └┐║
  8.               ╨    ╨ ╨───╨   ╨   ╙───╜ ────╜ ╙───╜ ╨    ╨ ╨   └╨
  9.                      v   e   r   s   i   o   n     3  .  1
  10.                 Copyright (C) 1991, /\/\ountainTop Technologies
  11.                   All Rights Reserved. Written by Nick Tucker.
  12.  
  13.  
  14.  Why the need for such a complicated algorithm?
  15.  ──────────────────────────────────────────────
  16.  There was a need for a quick and easy way checking files for viruses
  17.  on BBS systems (Recent Uploads can always be a hazard, especially when
  18.  left unattended). There are many "shells" that are available, but they
  19.  are either too slow or don't work correctly. AUTOSCAN was written to 
  20.  work with the McAffee SCAN program and various archiving programs.
  21.  
  22.  Required Files
  23.  ──────────────
  24.  PKUNZIP.EXE
  25.  PAK.EXE
  26.  PKUNPAK.EXE (or PKXARC.EXE and/or XARC.EXE)
  27.  LHARC.EXE (or ICE.EXE)
  28.  ARJ.EXE
  29.  SCAN.EXE
  30.  
  31.  (All of the current versions can be obtained from my board or the support
  32.  boards).
  33.  
  34.  How does it work?
  35.  ─────────────────
  36.  The way it works is very simple, all it does is un-archive any ZIP, ARC,
  37.  ICE, LZH, PAK, or ARJ file into a work directory (\AUTOSCAN.30), then
  38.  use McAffee's SCAN.EXE to scan it for any virus (Since SCAN is updated
  39.  regularly, you don't have to worry about AutoScan becoming outdated or
  40.  missing any recent viruses.) If all goes well and no viruses are found,
  41.  it deletes all the "work" files and then moves onto the next file and
  42.  repeats the process.
  43.  
  44.  To get going is real simple, copy AUTOSCAN.EXE into a directory in your
  45.  path ( example in AUTOEXEC.BAT:
  46.  
  47.  PATH = C:\;C:\UTIL;
  48.  
  49.  when AUTOSCAN.EXE is in C:\UTIL ).  Change to the directory you wish to
  50.  scan, and type "AUTOSCAN". 
  51.  AutoScan will then look through the Current Directory for ZIP, ARC, 
  52.  ICE, PAK, LZH, ARJ and SDN files, un-archive them and scan them, if all
  53.  goes well it will proceed onto the next file. In order for everything to
  54.  work all the un-archivers should be within reach upon the currect path,
  55.  PKUNPAK.EXE, PKUNZIP.EXE, LHARC.EXE, ICE.EXE, PAK.EXE, ARJ.EXE and, most
  56.  importantly, SCAN.EXE.  If any of the un-archivers are not found that 
  57.  section will not execute, you don't need them all to run AUTOSCAN, 
  58.  however if SCAN.EXE is not located the program will halt.
  59.  
  60.  AutoScan will keep a detailed log of it's activities in the same
  61.  directory that contains AUTOSCAN.EXE appropriately named AUTOSCAN.LOG. 
  62.  If it already exists, new information will be appended to it.
  63.  
  64.  "What if?" he said
  65.  ──────────────────
  66.  What if there is an archive within an archive? AutoScan will detect if there
  67.  are any archives within archives - to any level and any combination of
  68.  archive types. If an error is located in a "sub archive" that name is placed
  69.  in the log along with the main archive name and what the error was - Virus
  70.  or bad archive.  
  71.  
  72.  About ARC
  73.  ─────────
  74.  AutoScan supports most major ARC type archivers, PKPAK, PKARC and the SEA
  75.  ARC7, it can tell the difference between the three and will use the 
  76.  appropriate archiver to un-archive the file. If AutoScan detects a file
  77.  generated by the ARC7 archiver and XARC is not available that file will be 
  78.  skipped, however if XARC is found and PkPak or PkArc isn't, AutoScan will 
  79.  attempt to use ARC7 for the Arc type unarchiver.
  80.  
  81.  About PAK
  82.  ─────────
  83.  AutoScan, when examining a PAK archive, will only un-archive the type 10
  84.  compression (Crushed) and the type 11 compression (Distilled).
  85.  
  86.  
  87.  COMMAND LINE OPTIONS
  88.  ────────────────────
  89.  AUTOSCAN /S
  90.  If you wish to have your Hardrive scanned as well put a /S on the command
  91.  line.  Drives C: through H: will be scanned if they exist. Only EXE, COM,
  92.  SYS, PIF and OVR files will be checked.
  93.  
  94.  AUTOSCAN /Q 
  95.  When AutoScan finishes it sounds a two tone bell a few times, or in the
  96.  case of a VIRUS, many times! If you wish to run it in the QUIET MODE put
  97.  a /Q on the command line.
  98.  
  99.  AUTOSCAN /C 
  100.  This will trick AutoScan into thinking that there is a virus, and will do
  101.  the following:
  102.  1. Rename the archive to .BAD
  103.  2. Exit at an errorlevel of 1
  104.  3. Beep it's ass off if you're unregistered or not working in "Quiet" mode
  105.  You must have an archive in the current directory (ALONG WITH CHECK.EXE)
  106.  to use this.  You may use no other command line options.
  107.  
  108.  AUTOSCAN /R
  109.  AutoScan will rescan all files archives. This option is as if you had 
  110.  deleted AutoScan.Dat, which is exactly what AutoScan does.
  111.  
  112.  AUTOSCAN /M
  113.  AutoScan will instruct Scan.exe not to scan RAM at all. Without this option
  114.  RAM will be scanned only on the first pass or if a virus was found RAM will
  115.  be scanned again.
  116.  
  117.  AUTOSCAN /O
  118.  To scan a single file. This will not enter the name into AUTOSCAN.DAT, or
  119.  even check to see if it has been processed before. Just a quick and dirty
  120.  scan. IE: AUTOSCAN /OTEST.ZIP 
  121.  A path and file name can be specified, sorry no wildcards.
  122.  
  123.  AUTOSCAN /F
  124.  This will instruct AutoScan to reboot the machine once all operations have
  125.  been completed, a five (5) second count down can be aborted by pressing any
  126.  key. This feature is usefull if you are doing an entire drive scan and don't
  127.  want to sit around watching it run, when it's done it will reboot and bring 
  128.  up your BBS or Menu system if you have one. 
  129.  
  130.  AUTOSCAN /N  * - Registered Version.
  131.  This will instruct AutoScan to check for Bad Archives ONLY, only use this
  132.  option if you are sure the file is free of Virus's. 
  133.  
  134.  AUTOSCAN /A  * - Registered Version.
  135.  AUTOSCAN will search the ENTIRE DRIVE for archives and scan them. AUTOSCAN
  136.  will not update the AUTOSCAN.DAT or check to see if the file has been
  137.  processed. IE: AUTOSCAN /AC: If no drive is specified the default is used.
  138.  
  139.  AUTOSCAN /T  * - Registered Version.
  140.  This will instruct AutoScan to check the size, time and date of the archive.
  141.  If it has changed, the archive will be rescanned. If you run AutoScan from a
  142.  BBS to check any recent uploads you might not want to use this option. If you
  143.  add ZIP comments to a file, it will obviously change the file size and cause
  144.  AutoScan to rescan it.
  145.  
  146.  AUTOSCAN /D  * - Registered Version.
  147.  With this option you can specify the directory to scan on the command line.
  148.  IE: AutoScan /DF:\WORK . Any files in the F:\WORK directory will be scanned.
  149.  
  150.  AUTOSCAN /I  * - Registered Version.
  151.  All this does is supress the blue or red box upon completion, the same info
  152.  is written to the screen in a "normal manner".
  153.  
  154.  AUTOSCAN /B  * - Registered Version.
  155.  To direct AutoScan to place any .BAD files in a specified directory.
  156.  IE: AUTOSCAN /BC:\BADFILES  where C:\BADFILES is the directory.
  157.  
  158.  All command line options must be seperated by a space and they may be in 
  159.  any order you wish. 
  160.             AUTOSCAN /Q /R /BC:\BADFILES /I /DE:\RECENT
  161.  This would cause AUTOSCAN to run in Quiet Mode (/Q), rescan all files (/R),
  162.  copy all .BAD files to C:\BADFILES (/B), supress the ending screen (/I), 
  163.  and examine the directory E:\RECENT (/D). The Command line is limited to 
  164.  80 characters so keep those paths small!!
  165.  
  166.  AUTOSCAN.CFG
  167.  ────────────
  168.  Included in the Archive is a file called AutoScan.Cfg. In this file you can
  169.  set certain default settings for AutoScan. Edit this file with an ASCII editor
  170.  to suit your liking. If you wish to use different config files you can specify
  171.  the name on the command line with the /K option.
  172.  AUTOSCAN /KC:\AUTOCFG.CFG would cause AutoScan to use the Autocfg.Cfg file
  173.  in the root directory of drive C:. This option MUST BE THE FIRST OPTION 
  174.  otherwise it will be ignored. You can add further options on the command line
  175.  after the /k option, IE: AutoScan /KC:\AUTOCFG.CFG /R /I .
  176.  To set the command line parameters for SCAN.EXE use the /P option within the
  177.  current config file.  As many parameters can be used as long it is limited to
  178.  100 characters.  /P /A /FR will cause Scan to scan all files and display all
  179.  messages in french.
  180.  
  181.  HELP and SCAN.EXE
  182.  ─────────────────
  183.  For help on the fly type AUTOSCAN ? and it will display some information
  184.  about itself.
  185.  
  186.  In order for AutoScan to detect all known virus's you must keep your
  187.  version of SCAN.EXE as current as possible. AutoScan is only as good
  188.  as the Scanner it uses. SCAN.EXE can be found on most good bulletin 
  189.  boards in your area. 
  190.  
  191.  *.BAD
  192.  ─────
  193.  If AutoScan comes across a bad archive or a virus that file will be
  194.  renamed to "filename".BAD and make a note in the log indicating which
  195.  file is SUSPECT of being bad. If a file is flagged as being bad you 
  196.  might want to examine it manually to see why. If the /B option was used
  197.  that file would be copied to the specified directory.
  198.  
  199.  NEWLIST.TXT
  200.  ───────────
  201.  As AutoScan runs it generates a file called NEWLIST.TXT. In this file it
  202.  will place the names of any new files that it has just processed. If you
  203.  have an archive commenter that can use this file then please do. I am in
  204.  the process of writing one for ZIP files and it should be released soon.
  205.  
  206.  F10 - ABORT 
  207.  ───────────
  208.  While AutoScan is running pressing  F10 will cause AutoScan to abort the
  209.  current session.  AutoScan will only stop once the current file has been
  210.  finished and the work files have all been deleted. AutoScan will report on
  211.  the current status of it's operation and further runnings of AutoScan will
  212.  just pick up where it left off.  AutoScan will exit on an ERRORLEVEL of 0
  213.  in this case.
  214.  
  215.  AUTOSCAN.DAT
  216.  ────────────
  217.  Once AutoScan has completed its operations it will update a file called
  218.  AUTOSCAN.DAT, this file contains a list of files that have already been
  219.  scanned.  For sysops, this makes it possible to run AutoScan after users
  220.  have logged off the BBS, and if any new files were uploaded, they get
  221.  scanned right away and removed from circulation if needed. 
  222.  
  223.  The Naughty Bits
  224.  ────────────────
  225.  Each time AutoScan starts up it checks it's own size and CRC, and if it
  226.  has changed, it will terminate with a nasty message. AutoScan will also
  227.  check disk space each time it starts up. If the amount of disk space left
  228.  is less than 150% of the archive size AutoScan will exit on a ErrorLevel 1.
  229.  
  230.  Errorlevels
  231.  ───────────
  232.  AutoScan will exit on one of 5 DOS ErrorLevels..
  233.  
  234.            ErrorLevel 0 - New Files found and processed.
  235.            ErrorLevel 1 - SCAN.EXE missing / No Disk Space /
  236.                           AUTOSCAN.EXE infected / File Error.
  237.            Errorlevel 2 - No New Files. 
  238.            ErrorLevel 3 - Bad Archive, Renamed to .BAD.
  239.            ErrorLevel 4 - VIRUS, Renamed to .BAD.
  240.  
  241.  What In?
  242.  ────────
  243.  AUTOSCAN is written in Turbo Pascal 6.0 and some routines are from
  244.  the TechnoJock Turbo Toolkit V5.02 (excellent package if your a TP 4/5/6
  245.  programmer).
  246.  
  247.  AUTOSCAN uses many "outside" programs, without which AUTOSCAN would not
  248.  function. Please show your appreciation and register these fine programs.
  249.  
  250.  What If?
  251.  ────────
  252.  If AUTOSCAN does report that SCAN.EXE found a virus, what do I do?  Either
  253.  contact McAffee Associates, and they can guide you through getting rid of
  254.  the virus, or you can run SCAN.EXE manually with a /D on the command line.
  255.  SCAN /D will delete any file found with a virus.  Also Mace Utilities 1990
  256.  and CLEANPxx.ZIP will get rid of any viruses after they are detected.
  257.  
  258.  The key to virus protection is that ugly word "BACKUP"!  Always backup any
  259.  critical files that you may have.  
  260.  
  261.  The Best
  262.  ────────
  263.  This program would not be possible without the creation of these fine
  264.  programs:
  265.  
  266.  PKZip / PKPak  -  PKWare / Phil Katz             -  PKZ110.EXE
  267.  
  268.  PAK            -  NoGate Programming             -  PAK251.EXE
  269.  
  270.  ARC,XARC       -  System Enhancement Associates  -  N/A
  271.  
  272.  Lharc (LZH)    -  Yoshi                          -  LH114B.EXE
  273.  
  274.  Turbo Pascal   -  Borland Corporation            -  N/A
  275.  5.5 / 6.0
  276.  
  277.  TechnoJock     -  TechonoJock Software           -  TTT502.ZIP
  278.  5.02 
  279.  
  280.  SCAN           -  McAffee Associates             -  SCANV72.ZIP
  281.  
  282.  
  283.  The Rest  
  284.  ────────
  285.  AutoScan is distributed under the Shareware concept, and you are given a
  286.  LIMITED contract to use AutoScan.   You may use it free of charge for a
  287.  period of THIRTY (30) DAYS, and then you must register it. There is a
  288.  registration fee of $10.00 US dollars ($15.00 Canadian) which will entitle
  289.  you to the next version of AutoScan. See REGISTER.NOW for more details. A
  290.  lot of work has gone into creating this program, and if you would like to
  291.  see it continue, please contribute.  
  292.  
  293.  The author shall not be held responsible for any hardware or software damage
  294.  associated.  You are using this program at your own risk.
  295.  
  296.  You are NOT allowed to distribute this program for any money, but are able
  297.  to distribute it for fee but only for the amount of the disk and/or the 
  298.  price of postage.
  299.  
  300.  Final Word
  301.  ──────────
  302.  Thank you to everyone who helped out with the nasty task of debugging
  303.  this thing...THANKS! THANKS! THANKS!...
  304.  
  305.  Thanks to Eric Boehm for putting the seed to this program in my head and
  306.  testing many different versions in the same day! 
  307.  Thanks to all those in the Pascal Echo who help me with some of the
  308.  stranger points in this program. You can always find me in there! 
  309.  Thanks to Josh for help with these docs..
  310.  
  311.  My Beta testers:
  312.   Josh Linder, Rich Lowenburg, Bob Moravsik (The infamous!!!) and Eric
  313.   Boehm and all the others who moaned about the Runtime Error 5 and 6
  314.   of Version 2.0!.
  315.   
  316.  Where to find me
  317.  ────────────────
  318.  Somewhere in the FidoNet Pascal Echo, Virus Echo and the Virus Info Echo.
  319.  or at:
  320.  
  321.                    /\/\ountainTop Technologies
  322.                    91 Sage Ct.
  323.                    Bedminster, NJ 07921 USA
  324.                    ATTN:Nick Tucker
  325.  
  326.  
  327.  
  328.